home *** CD-ROM | disk | FTP | other *** search
/ Komputer for Alle 2001 #5 / CD 5 (Black) - 2001.iso / System / MDAC / mdac_fin.exe / Sqlsrdme.txt < prev    next >
Encoding:
Text File  |  1999-08-05  |  13.3 KB  |  306 lines
  1. ****************************************************************
  2.                       MICROSOFT SQL SERVER
  3.         ODBC-OHJAIN MICROSOFT SQL SERVERI─ VARTEN
  4.            ASENNUKSEN LUEMINUT-TIEDOSTO, VERSIO 3.7
  5. ****************************************************************
  6.  
  7. TΣssΣ tiedostossa kuvataan Microsoft SQL Server ODBC-ohjaimen 
  8. version 3.7 kΣyttΣmistΣ Microsoft SQL Serverin version 6.5 tai
  9. edeltΣvien versioiden kanssa.
  10.  
  11. Koska Microsoft SQL Server ODBC-ohjaimen versio 3.7 toimitetaan 
  12. SQL Server version 7.0 mukana, SQL Server version 7.0 kΣyttΣjien
  13. tulee tΣmΣn ohjaimen osalta kΣyttΣΣ SQL Server version 7.0 
  14. ohjemateriaaliin sisΣltyviΣ ohjeita tΣmΣn lueminut-tiedoston 
  15. asemesta.
  16.  
  17. Asiakirjassa on kΣsitelty seuraavia aiheita:
  18.  
  19. 1. YleistΣ
  20. 2. Instcat.sql:n asentaminen palvelimeen
  21. 3. SQL Serverin ty÷asemaohjelman verkkokirjastojen hakeminen
  22. 4. LisΣtietolΣhteitΣ ODBC:n kΣyttΣmisestΣ SQL Serverin kanssa
  23. 5. Ohjaimen kΣyttΣminen kehitysympΣrist÷ssΣ
  24. 6. Yhteensopivuudesta
  25.  
  26. ****************************************************************
  27. 1. YleistΣ
  28.  
  29. Microsoft SQL Server ODBC-ohjaimen versio 3.7 on Win32 ODBC 
  30. versio 3.51 -ohjain. TΣtΣ ohjainta voidaan kΣyttΣΣ sovellusten 
  31. kanssa, jotka on kirjoitettu joko ODBC 2.X- tai ODBC 3.X 
  32. -sovellusliittymiΣ varten. Ohjain toimii Microsoft SQL Server 
  33. 4.21a:n tai uudemman version kanssa. KΣytt÷jΣrjestelmΣ voi olla
  34. Windows 98, Windows 95 tai Windows NT (4.0 tai uudempi).
  35.  
  36. SQL Server ODBC-ohjaimen version 3.7 kanssa asennetaan my÷s 
  37. Win32-versio SQL Server version 7.0 Client Network Utility 
  38. -ohjelmasta. Voit kΣyttΣΣ tΣtΣ ohjelmaa Microsoft SQL Server 
  39. 4.21a:n tai uudemman version kanssa sekΣ niiden ty÷aseman
  40. verkkokirjastojen kanssa, jotka toimitetaan kyseisten SQL
  41. Serverin versioiden mukana.
  42.  
  43. ****************************************************************
  44. 2. Instcat.sql:n asentaminen palvelimeen
  45.  
  46. SQL Server ODBC-ohjain noutaa tietoja SQL Serverin jΣrjestelmΣ-
  47. luettelosta jΣrjestelmΣΣn tallennettujen toimintosarjojen
  48. eli luetteloon tallennettujen toimintosarjojen avulla. Kukin
  49. SQL Server ODBC-ohjaimen versio on suunniteltu kΣyttΣmΣΣn 
  50. tiettyjΣ luetteloon tallennettujen toimintosarjojen versioita.
  51.  
  52. SQL Server ODBC-ohjaimen version 3.7 mukana toimitettu 
  53. Instcat.sql-tiedosto pΣivittΣΣ luetteloon tallennetut 
  54. toimintosarjat tΣmΣn ohjaimen kΣyttΣmiksi versioiksi. SQL 
  55. Server ODBC-ohjaimen version 3.7 mukana toimitettu
  56. Instcat.sql-tiedosto on sama kuin SQL Server version 7.0 mukana
  57. toimitettu. SQL Server version 7.0 kΣyttΣjien ei tarvitse
  58. suorittaa Instcat.sql-tiedostoa.
  59.  
  60. SQL Serverin jΣrjestelmΣnvalvojan tulee pΣivittΣΣ luetteloon
  61. tallennetut toimintosarjat Instcat.sql-komentosarjan 
  62. avulla, jotta ohjain toimisi oikein. Toimintosarjojen 
  63. pΣivittΣminen ei vaikuta vanhempien SQL Server -asiakkaiden
  64. toimintaan. Kaikki Microsoft SQL Serverin versiot 4.21a - 6.5 
  65. on pΣivitettΣvΣ. SQL Server versiota 7.0 ei pΣivitetΣ.
  66.  
  67. JΣrjestelmΣnvalvoja pΣivittΣΣ SQL Server version 4.21a, 6.0 tai
  68. 6.5 luetteloon tallennetut toimintosarjat suorittamalla 
  69. Instcat.sql-komentosarjan isql-apuohjelman avulla (ohjeet alla).
  70. PΣΣtietokannasta on tehtΣvΣ varmuuskopio ennen tietojen 
  71. muuttamista. Voit suorittaa isql-apuohjelman vain SQL Server 
  72. -ty÷asemaksi asennetulla tietokoneella.
  73.  
  74. Suorita Instcat.sql-komentosarja isql-apuohjelman avulla 
  75. kehotteessa esimerkiksi seuraavasti:
  76.  
  77. C:>ISQL /Usa /Pjv_salasana /Spalvelimen_nimi 
  78. /isijainti\Instcat.Sql
  79.  
  80. missΣ:
  81. jv_salasana
  82.     on jΣrjestelmΣnvalvojan salasana.
  83. palvelimen_nimi 
  84.     on palvelin, johon SQL Server on asennettu.
  85. sijainti 
  86.     on Instcat.sql-tiedoston koko polku.
  87.  
  88. Instcat.sql-komentosarja luo useita sanomia. Suurin osa nΣistΣ
  89. kertoo, miten monta riviΣ komentosarjan kΣynnistΣmΣt 
  90. Transact-SQL-lauseet ovat muuttaneet. Voit ohittaa useimmat 
  91. sanomat, mutta tarkista, ilmoittaako jokin sanoma toiminta-
  92. virheestΣ. Kun Instcat.sql-komentosarja suoritetaan SQL 
  93. Serverin versiossa 6.0, voit ohittaa sanoman, joka ilmoittaa, 
  94. ettei sp_MS_upd_sysobj_category-objektia ole olemassa. Viimeisen
  95. sanoman tulisi kertoa, ettΣ Instcat.sql-komentosarjan 
  96. suorittaminen on onnistunut. Instcat.sql-komentosarja 
  97. epΣonnistuu, jos pΣΣtietokannassa ei ole tilaa luetteloon
  98. tallennetuille toimintosarjoille tai entisiin toimintosarjoihin
  99. tehtyjen muutosten lokitiedostolle.
  100.  
  101. ****************************************************************
  102. 3. SQL Serverin ty÷asemaohjelman verkkokirjastojen hakeminen
  103.  
  104. SQL Server ODBC-ohjain muodostaa yhteyden palvelimeen SQL 
  105. Serverin ty÷aseman verkkokirjastojen avulla. SQL Server 
  106. ODBC-ohjain 3.7 hallitsee ODBC-tietolΣhteeseen liittyvΣΣ
  107. verkkokirjastoa SQL Serverin ty÷aseman mΣΣritystoiminnon avulla.
  108.  
  109. SQL Server ODBC-ohjain 3.7 asentaa vain yhden verkkokirjaston:
  110. nimetyn putken Win32-verkkokirjaston Dbnmpntw.dll.
  111.  
  112. Voit kΣyttΣΣ SQL Server ODBC-ohjaimen versiota 3.7 vanhempien
  113. Win32-verkkokirjastojen kanssa. Jos SQL-palvelinyhteyden
  114. muodostamiseen tarvitaan muuta kuin nimetyn putken verkko-
  115. kirjastoa, voit kΣyttΣΣ SQL Serverin mukana toimitettua verkko-
  116. kirjastoa. Saat SQL Serverin verkkokirjastot kΣytt÷÷si
  117. asentamalla Win32 SQL Serverin ty÷asematoiminnot omaan
  118. SQL Serverin versioosi.
  119.  
  120. SQL Server ODBC-ohjaimen version 3.7 mukana asennettua SQL
  121. Serverin ty÷aseman mΣΣritystoiminnon versiota voi kΣyttΣΣ
  122. SQL Server 4.21a:n tai uudempien versioiden ty÷asemien
  123. verkkokirjastojen kanssa.
  124.  
  125. ****************************************************************
  126. 4. LisΣtietolΣhteitΣ ODBC:n kΣyttΣmisestΣ SQL Serverin kanssa
  127.  
  128. Koska Microsoft SQL Server ODBC-ohjaimen versio 3.7 toimitetaan
  129. SQL Server version 7.0 mukana, SQL Server version 7.0 kΣyttΣjΣt
  130. voivat tΣmΣn ohjaimen osalta kΣyttΣΣ SQL Server version 7.0 
  131. ohjemateriaaliin sisΣltyviΣ ohjeita.
  132.  
  133. Kun SQL Server ODBC-ohjaimen versiota 3.7 kΣytetΣΣn SQL Serverin
  134. (version 4.21a, 6.0 tai 6.5) kanssa, ohjain toimii samoin kuin 
  135. vanhemmat ohjaimet. Voit kΣyttΣΣ kyseisen SQL Serverin version 
  136. mukana toimitettavia ohjainkohtaisia tietoja. NΣitΣ ovat:
  137.  
  138. * drvssrvr.hlp-tiedosto, joka toimitettiin SQL Serverin 
  139. aikaisemman version mukana.
  140.  
  141. * Luku "Programming ODBC for Microsoft SQL Server" SQL Server 
  142. version 6.5 kΣytt÷oppaassa.
  143.  
  144. * Painamaton paperi "Using ODBC with Microsoft SQL Server", joka
  145.  on saatavilla MSDN:ssΣ.
  146.  
  147. Microsoft SQL Server ODBC-ohjaimeen 3.7 sopivat my÷s
  148. ohjainkohtaiset lisΣtiedot teknisessΣ huomautuksessa "Using ODBC
  149. with Microsoft SQL Server", joka on saatavilla MSDN:ssΣ.
  150.  
  151. SQL Server ODBC-ohjain 3.7:n mukana toimitetaan 
  152. Sqlsodbc.hlp-tiedosto, joka sisΣltΣΣ tapauskohtaisia ohjeita
  153. SQL Server ODBC-tietolΣhteiden ohjatusta toiminnosta. Aiempien
  154. SQL Server ODBC-ohjaimien mukana toimitettu 
  155. Drvssrvr.hlp-tiedosto sisΣltΣΣ aiempien ohjainversioiden 
  156. tietoja. Tiedoston vanhempien versioiden tiedot ovat my÷s SQL 
  157. Server 6.5:n oppaassa "Programming ODBC for 
  158. Microsoft SQL Server".
  159.  
  160. ****************************************************************
  161. 5. Ohjaimen kΣyttΣminen kehitysympΣrist÷ssΣ
  162.  
  163. SQL Server ODBC-ohjain kΣyttΣΣ ohjainkohtaisia
  164. parametreja useissa ODBC-funktioissa. NΣiden ohjainkohtaisten 
  165. parametrien ja C- ja C++-ohjelmointirakenteiden mΣΣritykset 
  166. ovat Odbcss.h-tiedostossa.
  167.  
  168. SQL Server ODBC-ohjain 3.7 on yhteensopiva Odbss.h-tiedoston
  169. kanssa. Tiedoston saa seuraavista lΣhteistΣ:
  170.  
  171. * Sql Server 7.0
  172.  
  173. * SQL Server 6.5 Service Pack 2 (SP2) tai uudempi
  174.  
  175. * MDAC SDK
  176.     MDAC SDK kuuluu Microsoft Developer
  177.     Network Professional Editioniin. Voit my÷s ladata 
  178.     SDK:n Microsoftin Web-sivulta osoitteesta
  179.     http://www.microsoft.com/data. SDK on my÷s
  180.     Microsoft Pressin "Microsoft ODBC 3.0 Software 
  181.     Development Kit and Programmer's Reference" 
  182.     -julkaisussa.
  183.  
  184. ****************************************************************
  185. 6. Yhteensopivuudesta
  186.  
  187. Koska ODBC-ohjaimen versio 3.7 toimitetaan SQL Server version 
  188. 7.0 mukana, SQL Server version 7.0 kΣyttΣjien tulee tarkistaa
  189. yhteensopivuustiedot SQL Server 7.0:n ODBC-ohjeista. TΣssΣ
  190. luvussa esitellyt yhteensopivuustiedot pΣtevΣt vain kΣytettΣessΣ
  191. tΣtΣ ohjainta SQL Serverin aikaisempien versioiden kanssa 
  192. (4.21a, 6.0 ja 6.5).
  193.  
  194. SQL Server ODBC-ohjain 3.7:ssa on uusi ohjattu toiminto, joka
  195. kΣynnistyy, kun liitΣt tai mΣΣritΣt tietolΣhteitΣ ODBC-hallinnan
  196. avulla tai kun jokin sovellus kutsuu SQLConfigDataSource
  197. -komentoa ja pyytΣΣ ohjainta pyytΣmΣΣn tietoja kΣyttΣjΣltΣ. Saat
  198. ohjeita ohjatusta toiminnosta valitsemalla Ohje-painikkeen 
  199. ohjatun toiminnon ikkunassa.
  200.  
  201. SQL Server ODBC-ohjaimen versiossa 2.65, joka toimitettiin
  202. SQL Server 6.5:n mukana, SQL_COPT_SS_PERF_QUERY_INTERVAL-
  203. toiminto kesti sekunteja eikΣ millisekunteja, kuten ohjeissa 
  204. ilmoitettiin (katso Knowledge Base -tietokannan artikkelia 
  205. Q157753). SQL Server ODBC-ohjaimen versiossa 3.7 
  206. SQL_COPT_SS_PERF_QUERY_INTERVAL kestΣΣ millisekunteja, kuten 
  207. ohjeissa ilmoitetaan.
  208.  
  209. Seuraavat muutokset vaikuttavat vain sovelluksiin, jotka on 
  210. kirjoitettu ODBC 3.X:n sovellusliittymΣn avulla. Muutokset eivΣt
  211. koske sovelluksia, jotka on kirjoitettu ODBC 2.X:n 
  212. sovellusliittymΣn avulla. NΣiden muutosten ei pitΣisi vaikuttaa 
  213. tulosjoukkojen kΣsittelyyn useimmissa ODBC-sovelluksissa.
  214.  
  215. SQL Server ODBC-ohjaimen aiemmissa versioissa yhtenΣiset
  216. komentojonojen tai tallennettujen toimintosarjojen PRINT- tai 
  217. RAISERROR-lauseet palauttivat sanomansa yhtenΣ tulosjoukkona. 
  218. Versiossa 3.7 kunkin SQL-lauseen sanomat muodostavat oman 
  219. tulosjoukkonsa. Saat seuraavan SQL-lauseen sanoman nΣytt÷÷n 
  220. kutsumalla SQLMoreResults-funktion jokaisen sanoman jΣlkeen. 
  221. Yhden SQL-lauseen, esimerkiksi DBCC-lauseen, sanomat muodostavat
  222. yhden tulosjoukon, eikΣ niiden vΣlillΣ tarvitse kutsua 
  223. SQLMoreResults-funktiota.
  224.  
  225. SQL Server ODBC-ohjaimen aiemmissa versioissa komentojonojen 
  226. tai tallennettujen toimintosarjojen ensimmΣisessΣ lauseessa 
  227. ilmennyt suorituksenaikainen virhe tai RAISERROR, jonka 
  228. vakavuusaste on vΣhintΣΣn 11, aiheutti aina SQL_ERROR-virheen 
  229. SQLExecute-, SQLExecDirect- tai SQLParamData-lauseessa. 
  230. Versiossa 3.7 SQLExecute-, SQLExecDirect- ja SQLParamData
  231. -lauseet palauttavat SQL_ERROR-virhetuloksen vain siinΣ 
  232. tapauksessa, ettΣ muita lauseita ei suoriteta ensimmΣisen 
  233. jΣlkeen. Jos ensimmΣisen lauseen jΣlkeen suoritetaan jokin muu 
  234. lause, kuten yksinkertainen RETURN-lause, joka ei anna tuloksia,
  235. SQLExecute- tai SQLExecDirect-lauseet palauttavat tuloksen 
  236. SQL_SUCCESS_WITH_INFO. Kun olet kΣsitellyt 
  237. SQL_SUCCESS_WITH_INFO-sanomat SQLGetDiagRec-funktion avulla, 
  238. saat seuraavan tulosjoukon kutsumalla SQLMoreResults-lauseen.
  239.  
  240. Kun ohjaimen aiemmat versiot kohtasivat virheen komentojonojen 
  241. tai tallennettujen toimintosarjojen ensimmΣisessΣ lauseessa, 
  242. kΣskyn kahvaa voi kΣyttΣΣ toisessa SQL-lauseessa, kun 
  243. SQLExecute- tai SQLExecDirect-funktio palautti tuloksen 
  244. SQL_ERROR. Kun ohjaimen versio 3.7 palauttaa tuloksen 
  245. SQL_SUCCESS_WITH_INFO, lause ei voi kΣsitellΣ toista 
  246. SQL-lausetta, kunnes SQLMoreResults-funktio palauttaa tuloksen 
  247. SQL_NO_DATA tai kunnes kaikki RAISERRORia seuraavat
  248. tulosjoukot on suljettu. Jos virhesanomaa ei seuraa tulosjoukko,
  249. SQLCloseCursor-lausetta ei voi kutsua. KΣskyn kahvan voi 
  250. vapauttaa kΣsittelemΣΣn toista SQL-lausetta kutsumalla 
  251. SQLFreeStmt(SQL_CLOSE)- tai SQLMoreResults-funktion
  252. seuraavasti:
  253.  
  254. CREATE PROCEDURE TestPrc @Parm1 as
  255. IF (@Parm1 IS NULL)
  256. BEGIN
  257.     RAISERROR ('Parm1 cannot be NULL', 11, 1)
  258.     RETURN
  259. END
  260. SELECT * FROM sysusers WHERE suid = @Parm1
  261. GO
  262.  
  263. Suorita seuraava komento:
  264.  
  265. SQLExecDirect(hstmt, "{ call TestPrc (NULL) }", SQL_NTS);
  266.  
  267. Kun kΣytΣt SQL Server ODBC-ohjaimen vanhempaa versiota tai jos 
  268. sovellus kΣyttΣΣ ODBC 2.X -sovellusliittymΣΣ, SQLExecDirect
  269. -funktio palauttaa tuloksen SQL_ERROR. Kun SQLGetDiagRec-funktio
  270. on palauttanut tuloksen SQL_NO_DATA tai SQLError on palauttanut
  271. tuloksen SQL_NO_DATA_FOUND, kΣskyn kahva on vapaa kΣsittelemΣΣn
  272. toisen SQL-lauseen.
  273.  
  274. Kun SQL Server ODBC-ohjaimen versiota 3.7 kΣytetΣΣn 
  275. sovelluksesta, joka on kirjoitettu ODBC 3.X -sovellusliittymΣn 
  276. avulla, SQLExecDirect-funktio palauttaa tuloksen 
  277. SQL_SUCCESS_WITH_INFO. Kun SQLGetDiagRec-funktio on palauttanut
  278. tuloksen SQL_NO_DATA, kΣskyn kahva ei voi kΣsitellΣ toista
  279. SQL-lausetta, kunnes SQLMoreResults-funktio palauttaa tuloksen 
  280. SQL_NO_DATA tai SQLFreeStmt(SQL_CLOSE)-funktio kutsutaan.
  281.  
  282. Ohjaimen aiemmissa versioissa SQLExecute-, SQLExecDirect- tai
  283. SQLParamData-funktio palauttaa tuloksen SQL_SUCCESS, kun 
  284. sovellus suorittaa haetun UPDATE- tai DELETE-lauseen, jolla ei 
  285. ole vaikutusta riveihin. TΣtΣ varten ohjaimen versio 3.7 
  286. palauttaa edelleen tuloksen SQL_SUCCESS sovelluksiin, jotka on 
  287. kirjoitettu ODBC 2.X -sovellusliittymΣn avulla, ja tuloksen 
  288. SQL_NO_DATA sovelluksiin, jotka on kirjoitettu ODBC 3.X 
  289. -sovellusliittymΣn avulla.
  290.  
  291. Jos joko ODBC 2.X -sovellus, joka saa arvon SQL_SUCCESS, tai 
  292. ODBC 3.X -sovellus, joka saa arvon SQL_NO_DATA, kutsuu 
  293. SQLRowCount-funktion, lause palauttaa mΣΣrΣn nolla.
  294.  
  295. ODBC 3.X mΣΣrittΣΣ tulosten palautustavan selvemmin kuin 
  296. ODBC 2.X. SQL Server ODBC-ohjaimen aiemmat versiot palauttivat
  297. tulosparametrien ja palautuskoodien arvot, kun ODBC 2.X:n 
  298. SQLFetch-tai SQLExtendedFetch-funktiot palauttivat tuloksen 
  299. SQL_NO_DATA tallennetun toimintosarjan palauttamassa viimeisessΣ
  300. tulosjoukossa. SQL Server ODBC-ohjaimen versio 3.7 toimii 
  301. samalla tavalla ODBC 2.X -sovellusten yhteydessΣ. Kun versiota
  302. 3.7 kΣytetΣΣn ODBC 3.X -sovellusten kanssa, ohjain ei palauta
  303. tulosparametreja eikΣ palautuskoodeja, kunnes 
  304. SQLMoreResults-funktio palauttaa tuloksen SQL_NO_DATA.
  305. ****************************************************************
  306.